home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
HyperLib 1997 Winter - Disc 1
/
HYPERLIB-1997-Winter-CD1.ISO.7z
/
HYPERLIB-1997-Winter-CD1.ISO
/
オンラインウェア
/
BUS
/
BibTeX 1.06 FAT.sit
/
BibTeX ƒ
/
BibTeX.ReadMe
< prev
next >
Wrap
Text File
|
1996-06-04
|
8KB
|
174 lines
# ###################################################################
#
# FILE: "BibTeX.ReadMe"
# created: 4/2/96 {6:50:21 pm}
# last update: 4/6/96 {10:28:25 am}
# Author: Vince Darley
# E-mail: <mailto:vince@das.harvard.edu>
# mail: Division of Applied Sciences, Harvard University
# Oxford Street, Cambridge MA 02138, USA
# www: <http://www.fas.harvard.edu/~darley/>
#
# Mac port copyright (C) 1996 Vince Darley.
#
# Freely distributable, please report bugs (and fixes) to
# the author.
#
# ###################################################################
This is BibTeX (fat)
====================
BibTeX is the bibliography handling tool related to the TeX/LaTeX
typesetting system (available on almost all conceivable OS platforms).
When a document is typeset with LaTeX, an auxiliary file (with extension
'.aux') is generated. This auxiliary file contains, amongst other things,
a list of references (to books, articles, research reports, web-url's,...)
cited in the original document. BibTeX takes this list, together with the
name of a style file (extension '.bst') and a list of bibliography
databases (extension '.bib') which are also given in the auxiliary file,
and produces a wonderfully formatted list of references which the LaTeX
system subsequently (and automatically) appends to your typeset document.
Hence BibTeX is really not at all useful without TeX/LaTeX (there are
several freeware/shareware/commercial versions for the MacOS: OzTeX,
CMacTeX, DirecTeX Pro, Textures). In fact this version of BibTeX is now
distributed with OzTeX 2.0. It is useful to have a good text editor which
knows about the particular format of LaTeX documents: on the Mac, the
editor Alpha is indispensible in this regard, both for editing and for its
apple-event communication with the various parts of a LaTeX system.
For those who think this sounds a bit too complicated, the benefits in
terms of quality of output (both textual and mathematical) and automatic
generation of all manner of numbering schemes (figures, equations,
sections), and document parts (table of contents, index, bibliography),
together with cross-platform availability, mean that many people consider
it the _best_ current system for producing quality documents.
Here are some links for further information:
・ Mathematical relevance: <http://e-math.ams.org/>
・ General TeX documentation: <http://www.cl.cam.ac.uk/TeXdoc/TeXdocs.html>
・ Archive of LaTeX documenation: <http://www.loria.fr/tex/english/index.html>
・ More LaTeX links: <http://molscat.giss.nasa.gov/LaTeX/externals.html>
・ The editor 'Alpha': <http://www.cs.umd.edu/~keleher/alpha.html>
・ Various TeX-related links: <http://www.bluesky.com/TeXlinks>
・ CMacTeX: <http://www.math.tamu.edu/~tkiffe/cmactex.html>
・ OzTeX: <http://198.207.242.3/authors/akt/oztex.html>
・ Textures: <http://www.bluesky.com/>
・ Archive of all TeX related material: <http://jasper.ora.com/ctan.html>
========================================================================
BibTeX version 1.06
It has no known bugs, however, use at your own risk; there is no
warranty.... The only known crashes seem to be due to low memory
conditions, so I now set the application's partition to 400k by default. I
think it should work with 365k on 680x0 machines, and 300k on PPC machines,
so you could lower the application's partition size.
Features:
・ it works;
・ switchable between 'bib' and 'small' modes. The 'big' mode increases
the size of biobiography resources such as the number of strings allowed.
・ copes with both Unix and Mac standard eol characters.
・ reasonably fast (the original bibtex code is sadly not up to scratch
as far as efficieny goes);
・ support high-level apple events etc. so you can drag a '.aux' file (or
several) onto it for processing, or send it an odoc event from Alpha...
・ friendly to other apps (actually calls WaitNextEvent);
・ Fat binary; also runs on 68k (but with less testing);
・ Source code available;
・ Common search path for both .bst and .bib files, although you
can of course keep them in separate directories if you like.
This version of BibTeX is totally free.
Recent changes:
1.06 Now copes with extended character set '泅...'. Not all TeX
implementations allow them, but if you pass one to BibTeX, it
will happily output it, assuming your version of TeX can cope.
Changed name of log window.
1.05 Recompiled with CW9, updated to take account of Powerplant
changes. Cosmetic change when selecting 'go' to re-run
a file - the window is now cleared first.
1.04 Minor (non-fatal) bug fixes --- all files properly closed and
flushed after a bibtex error, file eof's set correctly for .bbl
and .blg files.
Thanks for the bug reports!
1.03 Minor changes --- it now gives a message 'BibTeX run complete.'
in the log window, rather than just finishing. Documentation
update. I've fixed the FREF/BNDL problems, so drag'n'drop
really should work now ;-)
1.02 Switchable between Big and Small. Uses new memory allocation
scheme from Rick, so temporary memory is used rather than the
system heap. This means the application's given partition can
be much smaller (300k works for me). Added fref 'TEXT' resource
which was missing previously (so drag and drop will work under
all circumstances now).
1.01 Copes with Unix as well as Mac EOL characters
1.0 Original; soon to be distributed with OzTeX 2.0
========================================================================
The Editor 'Alpha'
Download a new version of Alpha if you're using < 6.2; the new versions
contain an enhanced LaTeX mode which knows how to interact with BibTeX.
========================================================================
Technical Stuff:
To Do:
・ Let paths be set in a dialog box
・ When there isn't enough memory a type 11 error is the usual message
--- a meaningful message should be given
・ Work out more accurately how much memory the application really needs
(it seems to crash rather than put up nice Powerplant messages
in a low memory situation).
・ Write to .blg and .bbl files asynchronously --- I've tried to do this,
but my code fails (crash!). Look in fileio.cp:PutC() if you think you
can fix this.
Any offers for help or suggestions for improvements much appreciated --- in
particular if someone wants to get to work on the to-do's, that'd be great.
------
Sources:
Based on the C code of the original MacBibTeX (0.99c) which I grabbed from
CTAN, and code generously donated by Rick Zaccone from his 'Makeindex'.
Icon adapted from one I grabbed off a folder from some collection on the net.
------
Compilation (with CodeWarrior 9):
Obtain the library 'MoreFiles' (preferably version 1.4.1/2). It should be
available from the info-mac archives.
・ Open the source code folder
・ Compile BibTeX68k.オ
・ Compile BibTeXPPC.オ
Move the resulting application "BibTeX" up one level so it can find 'BibTeX
inputs'. You may need to adjust the memory allocation (with Get Info), but
beyond that you're set.
-----
Personaliation:
You can edit a string resource with ResEdit to specify your own search
path. To do this open the app with ResEdit and look at the STR# resource
called "Path". You can add entries which look like the final one: a
complete path specification preceded by '2'. If you prefer, '0:' indicates
a path relative to the .aux file, and '1:' relative to the BibTeX
application.